Failure as an Interface: A Taxonomy of Errors Callers Can Act On
Error responses are read more often than success payloads, usually by someone deciding whether to retry, escalate, or rewrite a request. A practical taxonomy, stable codes, structured details, and a short review checklist turn failure output into a deliberate interface.